Manage Catalogs

A catalog is similar to a directory structure. It consists of libraries, data models, model versions, and templates. Catalog Management displays a hierarchical tree of Mart and lets you manage and compare your catalogs. It has all the features included in the Library Manager and Session Manager modules that were available in the previous releases of erwin® Data Modeler Workgroup Edition.

Following are some of the features in Catalog Management:

Libraries

Use libraries to group related models. Libraries add an extra level of security or isolate implementation differences, such as development and production environments. A library can be part of another library or can be present under the Mart.

Sorting

In a catalog, the libraries are sorted alphabetically, and the models within the libraries are also sorted alphabetically. Versions are sorted newest to oldest; Named Versions appear first, and then Delta Versions follow. The catalog entries sort in the following order: Libraries, Models, Templates, and Versions respectively.

Context Menu

The context menu appears when you select a catalog entry and right-click. You can use the context menu to cut, copy, paste, and delete a library, model, or template. You can also use the context menu to mark a Delta version and delete, hide, and unhide Named and Delta versions.

You can create, search, delete, copy, and move catalog entries; you can hide and unhide versions.

Search Models

You can search models within models loaded from mart. This increases performance of Mart Portal and fetch search results quickly. By default, Loaded Models is selected.

To search model, follow these steps:

  1. In the catalog pane, click .
  2. Click .
  3. Work with the following available options:
    Loaded Models

    Searches within models loaded frommart.

    All Models

    Searches within all models from mart.

  4. Enter a catalog name and click .
    Based on your search, catalogs appear.

To create Libraries, follow these steps:

  1. Go to Application Menu > Catalogs.
    The Catalogs page appears.

  2. In the Catalog pane, click .
    A library is added to the catalogs tree.
  3. Select the newly created library. and in the Catalog Details pane, click .
  4. Edit the Name and Description.

    In Name field, `(backtick), ~(tilde), @(at the rate), %(percentage), ^(carat), ()(brackets), -(hypen), _(underscore), +(plus), =(equal to), |(pipe), {}(flower bracket), [](square bracket), :(colon), ;(semi colon), .(dot) and ,(comma) are allowed.

  5. Click .

Refer to the following table for catalog tree icons and their descriptions:

Icon

Description

Indicates a Mart model

Indicates that the model is harvested to erwin ER360

Indicates that the model is harvested to erwin ER360 but has newer updates that are not harvested.

Indicates that the model was marked as a template while saving to the mart

Indicates an erwin DM project saved to mart

To create a Named version, follow these steps:

  1. Select either a Named version or a Delta version of a data model and click .

    A Named version is created.

  2. In the Catalog Details pane, edit the Name and Description.
  3. Click .

    The name and description of the Named version is updated.

To hide a model version, select a version from the Catalog pane, and click .

To unhide a model version, follow these steps:

  1. Select the model of that version, click .
  2. click .
    The Hidden Versions dialog appears.
  3. Select your version and click OK.

To compare two model versions, follow these steps:

  1. Select and right-click the version of a model to which you want to compare another file and click Select Left File.

    Alternatively, you can click and select the two versions that you want to compare.

  2. Select and right-click the another version of the same model and click Compare to <Version x>.
    The Compare DDL Files dialog appears.

    3. Ensure that selected DDL versions are committed to your source control repository.

To view DDL of a model version, select a version and click . You can also download the DDL file using .

To delete a catalog entry, select the entry and click .

The Delete button is disabled when the last existing version of a model, or all the versions of a model are selected. The catalog entry is permanently deleted from Mart and it cannot be recovered.